home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / pns52.zip / COMMOPNS.DOC < prev    next >
Text File  |  1992-01-05  |  10KB  |  277 lines
  1.  
  2.  
  3.                            ┌──┌─┐┌┐┐┌┐┐┌─┐┌─┐v5.2
  4.                            └──└─┘└ ┘└ ┘└─┘│─┘ ┌─┐
  5.                            D&M Enterprises│┌─┐└─┐
  6.                                           ││ │└─┘
  7.  
  8.  
  9.  
  10.                               January 2, 1991
  11.  
  12.                                 Shad Muegge
  13.                               Marcos R. Della
  14.  
  15.  
  16.                                  ____
  17.                        -------|\/ o  \------------------
  18.                           ____|    ,__| Association of
  19.                          /  o \/|____/  Babble Fish
  20.                         |__,    |____   Programmers
  21.                          \____|\/ o  \
  22.                               |    ,__| MEMBER
  23.                        -------|/\____/------------------
  24.  
  25.  
  26.        COMMOPNS is shareware, which means that you can use this program
  27.        for 30 days to decide whether you want to use it.  If you decide
  28.        you are going to use COMMOPNS, you must send in the registration fee.
  29.  
  30.        Send your COMMOPNS registration fee of $10.00 US to:
  31.  
  32.             Shad Muegge
  33.             P.O. BOX 4251
  34.             Santa Rosa, CA  95402
  35.  
  36.        This is a LIFETIME registration fee, meaning that you will never
  37.        have to pay for any future versions of COMMOPNS.
  38.  
  39.        COMMOPNS may be freely distributed in its original PKZIPed form.
  40.  
  41.        SUPPORT:  You can either send me a letter, to which I will gladly
  42.        respond, or you can call my BBS: The Babble Underground (707) 575-0636.
  43.  
  44.        Thanks to:
  45.           Fred P. Brucker for writing {COMMO}.
  46.           Tom Keller, for editing this file.
  47.           And everyone else who Beta Tested COMMOPNS.
  48.  
  49. BASIC CONCEPT:
  50.  
  51.       COMMOPNS.EXE - Displays a single directory at a time and
  52.         allows the user to TAG files.  When the program is exited,
  53.         it writes the TAGGED files out to a specified (or default)
  54.         file.
  55.  
  56. OPERATION:
  57.  
  58.     An up arrow in front of a name indicates a subdirectory which will
  59.     lead you up the directory tree.  Likewise, a down arrow indicates
  60.     a subdirectory which will lead you down the tree.
  61.  
  62.     COMMANDS:
  63.        <ENTER> Change to a SUBDIR or toggle the tag flag (See <SPACE>).
  64.  
  65.       <ARROWS> Moves selector bar around.
  66.  
  67.  <PGUP> <PGDN> Switches file display pages.  Useful if your directory
  68.                has more than 115 files in it!
  69.  
  70.   <HOME> <END> Move to the first/last item on the screen.
  71.  
  72.        <SPACE> Toggle the tag flag and advance to next file in the display.
  73.                Also updates approximate upload time estimate, if the -S
  74.                option was specified on the command line.
  75.  
  76.      <Any Key> Advance selector bar to filename starting with that key.
  77.                For example: Press M to jump to filenames starting with M.
  78.  
  79.           <F1> Bring up a small help list.
  80.  
  81.        <ALT-D> Change the drive.
  82.  
  83.        <ALT-E> Sort files by extension
  84.        <ALT-N> Sort files by filename
  85.        <ALT-T> Sort files by date & time
  86.  
  87.          <ESC> Exit and write tag file list.
  88.  
  89.  <ALT - F1/F2> Change colors for foreground/background main screen.
  90.  <ALT - F3/F4> Change colors for foreground/background highligh bar.
  91.  <ALT - F5/F6> Change colors for foreground/background status lines.
  92.  
  93.        <ALT-C> Save colors and display method (BIOS/Direct).
  94.  
  95.        <ALT-U> Untag all files.
  96.  
  97.        <ALT-S> Shell to DOS
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.                                 PAGE 1
  105.  
  106. BASIC IMPLEMENTATION:
  107.  
  108.         DSZ, HSLINK, and others allow a list of files to be specified
  109.         in a file.  For example:
  110.                     DSZ sz @C:\FILE.LST
  111.                     HSLINK @C:\FILE.LIST
  112.  
  113.          will upload all the files in C:\FILE.LST.
  114.  
  115.          In DSZ, the @, the drive letter and the : are all MANDATORY.
  116.  
  117.       Getting COMMOPNS to work with your terminal program, should be
  118.          simple, here's a example in a psuedo-terminal program
  119.          script language:
  120.  
  121.          Execute COMMONPNS C:\FILE.LST
  122.          Execute DSZ sz @C:\FILE.LST    { for ZMODEM  }
  123.       or Execute HSLINK @C:\FILE.LST    { for HSLINK }
  124.          Execute DEL C:\FILE.LST        { this is optional }
  125.  
  126.  
  127. SETUP FOR {COMMO}:
  128.  
  129.       1. Put COMMOPNS.EXE somewhere in your path.
  130.  
  131.       2. Insert the COMMOPNS.MAC file into your COMMO.MAC
  132.          file - using your favorite ASCII text editor.
  133.  
  134.       3. Load {COMMO}.
  135.  
  136.       4. Type <Ctrl-PageUp> to get COMMOPNS Upload Menu!
  137.  
  138.       5. UPLOAD UPLOAD UPLOAD
  139.  
  140. AUTOMATIC COMMOPNS in {COMMO} with ZMODEM!
  141.  
  142.       In COMMO.SET file, insert the line:
  143.         {aut=pnszup,^xB01}
  144.       Now, whenever you do a Zmodem upload, COMMOPNS will automatically execute.
  145.  
  146. SETUP IN A BATCH FILE:
  147.  
  148.    For Upload: Some terminal programs allow you to call external
  149.                batches for their file transfer protocols.
  150.  
  151.       Example Batch File: (Zmodem or HSLINK Upload)
  152.  
  153.       @ECHO OFF
  154.       COMMOPNS C:\FILE.LST
  155.       DSZ sz @C:\FILE.LST
  156.    or HSLINK @C:\FILE.LST
  157.  
  158.  
  159.  
  160.  
  161.                                  PAGE 2
  162.  
  163. USE WITH PKZIP:
  164.     This will allow you to pick files out of single or multiple
  165.     directories and zip them together.  Note that additional command
  166.     line parameters can be added to the PKZIP line to preserve paths, etc.
  167.  
  168.    PNSZIP.BAT:
  169.       @ECHO OFF
  170.       COMMOPNS C:\FILE.LST
  171.       PKZIP -a %1 @C:\FILE.LST
  172.  
  173.    Example command line:
  174.         PNSZIP PNSSRC.ZIP
  175.  
  176. PARAMETER DEFINITIONS:
  177.    - if no parameters are specified, then the file list is CREATED
  178.      in the DEFAULT drive ROOT directory.
  179.       (i.e. if COMMOPNS is run on C:, the file would be C:\FILE.LST)
  180.  
  181.    COMMOPNS [DRIVE:][PATH][FILEN] [-O<N|T|E>] [-D[DRIVE:][PATH][FNAME]] [-S<bps>]
  182.  
  183.          DRIVE: The drive where you want the file.  (ie. C:, D:, ... )
  184.          PATH: The path where you want to file.  (ie. \COMMO\)
  185.          FILEN: The file name, you want the list to be written.
  186.  
  187.          An Error Level 2 is returned for invalid tag list filename.
  188.  
  189.          -D: Optional directory in which to begin tagging.  The drive
  190.              specifier is only necessary if you wish to start up on a
  191.              drive other than the current drive.  Will allow wildcard
  192.              filename specifications (ie. *.pas) to choose only
  193.              selective files
  194.  
  195.          -S: Modem transfer speed, in Bits Per Second.  If this option is
  196.              specified, COMMOPNS will compute and display the approximate
  197.              time needed to transfer the tagged files.
  198.  
  199.         -ON: Sort in order of filename. (Default)
  200.         -OT: Sort in order of date & time.
  201.         -OE: Sort in order of extension.
  202.  
  203.          -H: A 40 x 16 screen setup for the HP95x palmtop computer.
  204.          -W: Display files across in rows.
  205.          -C: Display files down in columns. (Default)
  206.  
  207. ENVIRONMENT VARIABLE:
  208.         Setting a COMMOPNS environment variable in DOS will tell COMMOPNS
  209.         where to write the list of TAGGED files.
  210.  
  211.         For Example: SET COMMOPNS=C:\FILES.LST
  212.  
  213.         This will cause COMMOPNS to write the file list to C:\FILES.LST
  214.  
  215.         Specifing a name on the command line will override this environment
  216.         variable.
  217.  
  218.                                 PAGE 3
  219.  
  220. REVISION HISTORY:
  221.   Version            New Stuff/Fixes.
  222.  
  223.     5.2   Added support for HP95lx palmtop (-H option).
  224.           Fixed a bug in the -D start directory code.
  225.           You can display files across rows or down columns (-W or -C).
  226.           ALT-U was added to clear all tags.
  227.           Enter key now toggles tags too.
  228.           Added file date and size on status line.
  229.  
  230.     5.1a  Updated COMMOPNS.MAC to include support for HS/Link.
  231.  
  232.     5.1   BIOS calls removed and DesqView calls installed to support
  233.           virtual screens.  Changed the file specification option to
  234.           allow for wildcard specifications (ie: *.pas).  Fixed small
  235.           color problems and help file.
  236.  
  237.     5.0   Major re-write of the basic code to increase speed.
  238.           COMMOPNS enviroment variable added so you can specify the
  239.             file to be created by the program.
  240.           ErrorLevel 1 returned if there is an empty file list.
  241.           Direct Video writes re-written in assembly to increase display
  242.             speed to the screen.  BIOS calls still in place for DV users.
  243.           Alt-U added to toggle between BIOS and Direct Video writes.  This
  244.             parameter can be saved using the Alt-C (clone) option.
  245.           F1 now brings up a help screen with the basic commands.
  246.           Pressing a key to jump to a file
  247.           Error level 2 returned for invalid tag file list filename.
  248.  
  249.     #.#   These versions skipped in a cheap marketing attempt to cash in
  250.           on the version 5.0 mania.
  251.  
  252.     2.1   Bug fixes.
  253.  
  254.     2.0   Added color and ability to change colors.
  255.       -D start directory option.
  256.           -S Bits Per Second option, so COMMOPNS can display upload time.
  257.       Arrows for indicating directories.
  258.           Checks memory available, instead of crashing.
  259.  
  260. BUGS: (bugz), adj. [Slang], 1. crazy; insane. 2. any crawling insect
  261.  with sucking mouth parts and forewings thickened. 3. Problems with a
  262.  computer program.  (go figure!)
  263.  
  264.  - The program doesn't seem to work on the novell network. When it
  265.    reads in the directory, it doesn't find a ".." parent directory
  266.    file.
  267.  
  268. DETAILS:
  269.    {COMMO} is a product of Fred P. Brucker.
  270.    DSZ is a product of Omen Technology Inc.
  271.    PKZIP is a product of PKWARE, INC.
  272.    MPt is a product of Matthew Thomas.
  273.    HS/Link is a product of Sam Smith.
  274.  
  275.                                 PAGE 4
  276.  
  277.